perm filename TASTER.LES[W,LES] blob sn#006736 filedate 1972-04-07 generic text, type T, neo UTF8
00100	TASTER	by Les Earnest, Stanford A. I. Project,	    December 1971
00200	
00300	The TASTER program collects and stores winetasting information and
00400	produces summaries of the results.  As written, it can handle up to
00500	20 wines and 40 tasters, but these parameters can readily be varied
00600	(see source file: TASTER.SAI[W,LES]).
00700	
00800	All commands to this program must be ended with a <RETURN>.
00900	
01000	STARTUP
01100	
01200	To run the program, say "EX TASTER[W,LES]".  The program will then
01300	ask you if you know how to run it.  If your reply begins with "n",
01400	TASTER will type out this set of instructions.
01500	
01600	Next it will say "Input file, if any: " and wait for a response.
01700	If you have prepared a wine list in a separate file or wish to
01800	reexamine the contents of a file previously written by this program
01900	(see "W" command, below), give the name of the file.  Otherwise, hit
02000	<RETURN>.
02100	
02200	If you don't specify a file, you will then be asked for the number of
02300	wines.  Your answer must be greater than 0 and not greater than the
02400	upper bound (presumably 20).  You are then asked for the "SCALE".
02500	If you respond with an integer N, then the wines are to be scored on
02600	an absolute scale between 1 and N, N being the best attainable.  If
02700	you make N large (say, >20) you make it hard for yourself and the
02800	computer.  Alternatively, if you give a blank reply (or N=0), you
02900	are specifying that the wines are to be ranked on a scale from 1,
03000	representing the best wine, to W (the number of wines given above),
03100	representing the worst.
03200	
03300	COMMANDS
03400	
03500	After completion of the startup sequence, the program types "*" and
03600	waits for one of the following commands, each of which is a single
03700	letter followed by <RETURN>.  After executing the command, it comes
03800	back for another.  To stop the program type <CONTROL>C (on a Teletype)
03900	or <CALL> (on a display).
04000	
04100	N - Name wines
04200	
04300	Steps through the wines one by one, giving their names and associated
04400	notes, if any have been entered, or just a number followed by "NV"
04500	otherwise.  If you type just <RETURN>, nothing will be changed.
04600	Alternatively, you may change the entry by typing something like the
04700	following.
04800		62 Ch. Lynch Bages<TAB>$4.75 at 10 Minna St. in June 1970
04900	The year must come first and may be two digits, as above, or 4.  If
05000	there is no year given, it will be taken as non-vintage, which will
05100	print as "NV".  Next comes the name of the wine followed by a TAB
05200	and then any notes you wish to add.
05300	
05400	You can change just the year and name of the wine by leaving out the
05500	TAB and the remainder.  Alternatively, you can change just the notes
05600	by beginning with a TAB, that is, by omitting the year and name of
05700	the wine.
05800	
05900	P - Print forms
06000	
06100	This asks for "# of copies" and types out that many copies of a short
06200	form for gathering individual ratings.
06300	
06400	I - Input ratings
06500	
06600	This first asks for a person's name.  If you say ".", it will  assume
06700	you are talking about the last person mentioned.  It checks to see if
06800	it already has ratings from this person and, if so, says  "So  you've
06900	changed your mind, eh?".
07000	
07100	It next says "Ranks:" or "Scores:" (depending on which kind of scale
07200	you are using) and expects a set of integers separated by one or more
07300	spaces representing the ordered values you assign to the various
07400	wines.  Thus "3 1 2 4" assigns 3 to the first wine, 1 to the second,
07500	etc.  Both ranks and scores must be within the permissible range or
07600	you will get an error message.  Also each rank may only be used once
07700	(you are not permitted to rank two different wines in second place,
07800	for example).  If you give a blank response, you will return to the
07900	command loop.
08000	
08100	You are then asked for the "Year to drink:" and may enter estimates
08200	for each wine, preferably just the last two digits, e.g.
08300		72 74 77 99
08400	There is no error checking on these entries.
08500	
08600	It then asks for another "name:" and will repeat the above sequence
08700	until you give a blank name.
08800	
08900	T - Tasting date
09000	
09100	Lets you enter the date of the tasting.  If you don't specify one,
09200	the current date will used.
09300	
09400	L - List wines
09500	
09600	Lists the names of all wines and any associated notes.
09700	
09800	R - show Ratings
09900	
10000	Shows the ratings of all wines for each person.
10100	
10200	D - Distribution
10300	
10400	For each wine, shows the number of occurrences of each rating.   For
10500	example, if you were scoring on a scale of 10, there would be 10
10600	columns showing for each wine the number of people who assigned it a
10700	score of 1, 2, etc.
10800	
10900	C - Consensus rank
11000	
11100	Computes the mean rating (score or rank) for each wine and lists them
11200	in order by this consensus value, from best to worst.  Also gives the
11300	standard deviation, minimum, and maximum ratings for each wine.
11400	
11500	Y - Years to drink
11600	
11700	Shows the estimated year of drinkability for each wine for each
11800	person who expressed an opinion.  Also gives the earlist, latest, and
11900	mean years for each wine.
12000	
12100	A - show All
12200	
12300	This is equivalent to typing the commands L, R, D, C, Y in that order.
12500	
12600	B - set Base number or letter
12700	
12800	Normally the wines are numbered 1, 2, 3, ... .  This command lets you
12900	set the designator of the "first" wine to something else, such as
13000	"23" or "A".  If you give an integer, they will be numbered upward
13100	from there, while if you give a letter, they will step through the
13200	alphabet.
13300	
13400	F - File name
13500	
13600	Lets you specify the name of the file that will be written by the "W"
13700	command, below.  If you used an input file, and don't use this
13800	command the input file will be overwritten by the W command.
13900	
14000	W - Write data file
14100	
14200	This writes a text file, which can be named by the F command, above.
14300	The format is as follows.
14400	DATE:<TAB><date of tasting>
14500	WINES:<TAB><number of wines>
14600	SCALE:<TAB><0 if ranking was used, otherwise the scale used>
14700	
14800	<year and name of wine><TAB><notes on this wine>
14900	<repeat for each wine>
15000	
15100	<ratings of wines><TAB><years to drink><TAB><name of individual>
15200	<repeat for each individual>
15250	
15300	The <ratings of wines> are given in the same format as in the I
15400	command, above, namely integers separated by one or more spaces.  So
15500	are the <years to drink>.
15600	
15700	This preserves all the data that the program, which permits you to
15800	recover from a system crash or to peruse the data at a later time.
15900	Files may also be prepared in this format using a text editor.  In
16000	this case, the DATE line may be omitted, as can all the rating lines,
16100	but the WINES and SCALES lines must be given (with the labels in
16200	CAPITALS) and the list of wines must included.  TASTER will complain
16300	about any format or logical errors when you read the file.